Shareware Grab Bag/Shareware Grab Bag.iso/010/sargeant.arc/PALETPOP.HLP

Text File | 1986-11-26 | 25KB | 580 lines

@┌────────────┤ QUICK REFERENCE @├─────────────┐
@│             Palette Pop Keys               │
@│                                            │
@│  F1   Help                                 │
@│  F2   Quick Reference - Palette Pop Keys   │
@│  F3   Restore colors from Modify palette   │
@│  F4   Restore current Modify color         │
@│  F5   View colors from Standard palette    │
@│  F6   View current Standard default color  │
@│  F7   View colors from File palette        │
@│  F8   View current File color              │
@│  F9   Save Modify palette to file          │
@│  F10  Load palette from disk               │
@│  [ Z  Move palette pointer to color value  │
@│  X Y  Increase or decrease color value     │
@├────────────────────────────────────────────┤
@│  Esc  Close Palette Pops window            │
@│  ^X   Remove Palette Pops from memory if   │
@│       it is memory resident                │
@└────────────────────────────────────────────┘


FJ The EGA has 64 different color values for
 you to choose from, and it can display up to
 16 colors on the screen at one time.  Each
 one of the standard displayable colors can
 be changed to one of the available 64 color
 values.

 You can change the values of the displayable
 colors with Palette Pops.  JColors are
 modified Jby pointing to the the color you
 want to change and scrolling through the
 full range of 64 different EGA color values.

 Once you have modified Jyour colors, Palette
 Pops Jlets you store them to a file for
 future use.



F  @┌───────────────────────────────────────┐
F  @│J  To change a palette color you must   │
F  @│J  first select the color you wish to   │
F  @│J  change by moving                     │
F  @│J  the pointer (XJ)     G@╓─────┐@  G@╓─────┐@ │
F  @│J  underneath it with  G@║ 4   @│@  G@║ 6   @│@ │
F  @│J  the left and right  G@║ [-  @│@  G@║ -Z  @│@ │
F  @│J  arrow keys...       G@╚═════╛@  G@╚═════╛@ │
F  @└─────────────────────────────────────┬─┘
F                                        │
F       D╒════╡O   Palette Pops   D╞════╕F   │
F       D│                            │F   │
F       D│      0123456789ABCDEF      │F   │
F       D│      @█A█B█C█D█E█F█G█H█I█J█K█L█M█N█O█      │F   │
F       D│      @█A█B█C█D█E█F█G█H█I█J█K█L█M█N█O█      │F   │
F       D│      @█A█B█C█D█E█F█G█H█I█J█K█L█M█N█O█      │F   │
F       D│       X Q═══════════════════F═══╛
F       D│     └── EGA Colors ──┘     │

F @
┌──────────────────────────────────────────
┐
F @
│ JOnce you have positioned the pointer you 
│
F @
│ Jcan increase or decrease its color value 
│
F @
│ Jwith the Up Jand Down   G@╓─────┐@  G@╓─────┐@  
│
F @
│ Jarrow keys.  The Up    G@║ 8   │@  G@║ 2   │@  
│
F @
│ Jarrow increases the    G@║ X   │@  G@║ Y   │@  
│
F @
│ Jcolor value.  The      G@╚═════╛@  G@╚═════╛@  
│
F @
│ Jdown arrow decreases the color value.    
│
F @
└──────────────────────────────────────────
┘
FJ  The arrow keys will scroll through the full
  set of EGA color values, numbered from 0 to
  63, giving you 64 different color values to
  choose from.

  Palette Pops displays the values of the 16
  colors you Modify, along with the Standard
  EGA default colors and a palette of 16
  colors values you can load from a File of
  modified colors you previously saved.


F        D│ J┌─────── Palettes ───────┐ │
F        D│  Modify  JStandard   File   │
F  ╒═════D═══P 1        J1        1     │
F  │     D│ J└───── Color Values ─────┘ │
F  │
F  │ A┌────────────────────────────────────┐
F  └─A┤  The color values of each palette  │
F    A│  are displayed every time you move │
F    A│  the palette pointer or change a   │
F    A│  color value.                      │
F    A└────────────────────────────────────┘

F     These values are displayed to make it
     easier for you to compare the colors
     you Modify with the Standard EGA
     colors, or a color palette you load
     from a File.



F        D│ J┌─────── Palettes ───────┐ │
F    ╒═══D═P OModifyD  JStandard   File   │
F    │   D│    1       J 1        1     │
F    │   D│ J└───── Color Values ─────┘ │
F    │
    │
    │
F  A┌─┴────═════╡O Modify Palette A╞═════──────┐
F  A│ This is the palette that you Modify by │
F  A│ using the arrow keys. That is, any     │
F  A│ changes you make to the 16  color      │
F  A│ palette displayed in the  JPalette Pops │
F  A│ window will be to the  Modify palette. │
F  A│ The Modify palette can  be saved to a  │
F  A│ file by pressing the F9 key.           │
F  A╘════════════════════════════════════════╛




F A┌───────═══╡O Standard  Palette A╞═══───────┐
F A│  This palette stores the EGA default    │
F A│  colors.  You can use this palette to   │
F A│  restore or compare your Modified       │
F A│  colors to the EGA palette at any time. │
F A│                                         │
F A│  Unlike the Modify palette, the         │
F A│  Standard palette cannot be changed.    │
F A│  The values remain the same and are     │
F A│  displayed primarily for comparison     │
F A│  purposes only.                         │
F A╘═════════════════════════════╤═══════════╛
F                               │
                               │
F        D│ J┌─────── Palettes ───│J───┐ │
F        D│ J Modify  OStandardD Q══╛Jle   │
F        D│ J   1        1        1     │
F        D│ J└───── Color Values ─────┘ │


F        D│ J┌─────── Palettes ───────┐ │
F        D│ J Modify  Standard   OFileD Q══F══╕
F        D│ J   1        1        1     │F  │
F        D│ J└───── Color Values ─────┘ │F  │
                                        │
                                        │
F  A┌─────────═══╡O File Palette A╞═══──────┴──┐
F  A│  The File palette holds the values of  │
F  A│  colors you load from a palette file   │
F  A│  you have stored earlier.  When        │
F  A│  JPalette Pops is first invoked, the    │
F  A│  File palette holds the default EGA    │
F  A│  color values.                         │
F  A│                                        │
F  A│  Use the F9 key to save your current   │
F  A│  Modify color palette to a file. Press │
F  A│  F10 to load a palette file from disk. │
F  A└────────────────────────────────────────┘


F  JWhen modifying your color palette you may
  wish to refer to the Standard JEGA colors,
  or perhaps colors from a previously saved
  color palette.

  Even though the values of these palettes
  are always displayed when you move the
  palette pointer from left to right, it is
  generally better to see the actual color
  these values represent.

  Palette Pops Jprovides an easy way for you
  to look at an entire palette of colors or
  even an individual color.  Function keys
  F3J through F8J are used by Palette Pops
  Jto allow you to switch back and forth
  between the ModifyJ, Standard Jand File
  Jpalette's colors.


F @
┌──────────────────────────────────────────┐
F @│  G@╓────┐@  JRestore the Modify Jpalette      
│
F @
│  G@║ F3 │@  Jcolors: If you are looking at   
│
F @│  G@╚════╛@  the colors in the Standard EGA  
│
F @│  palette or the File palette, F3 will    
│
F @│  immediately restore the Modify colors.  
│
F @└──────────────────────────────────────────┘


F @
┌──────────────────────────────────────────┐
F @│  G@╓────┐@  JRestore the current color from  
│
F @│  G@║ F4 │@  Jthe Modify Palette:  You can    
│
F @│  G@╚════╛@  safely take a look at a single  
│
F @│  color from either the Standard or File  
│
F @│  palettes and return to your current     
│
F @│  Modify color value by pressing the F4   
│
F @│  key.                                    
│
F @└──────────────────────────────────────────┘


F @
┌──────────────────────────────────────────┐
F @│  G@╓────┐@  JView the Standard JEGA color     
│
F @│  G@║ F5 │@  Jpalette.  Lets you compare the  
│
F @│  G@╚════╛@  colors you are modifying to the 
│
F @│  Standard EGA colors.  This will not     
│
F @│  change any of the color values in the   
│
F @│  Modify palette.  Pressing F3 will       
│
F @│  restore the Modify palette color values 
│
F @└──────────────────────────────────────────┘

F @
┌──────────────────────────────────────────
┐
F @│  G@╓────┐@  JView the current color from the 
│
F @│  G@║ F6 │@  Standard JEGA color palette.     
│
F @│  G@╚════╛@  This key is the same as F5 but  
│
F @│  only for the current color value, that  
│
F @│  is, the color the palette pointer is    
│
F @│  pointing to.                            
│
F @└──────────────────────────────────────────┘


F @
┌──────────────────────────────────────────
┐
F @│ G@╓─────┐@ G@╓────┐@ JReset the color values of 
│
F @│ G@║ Ctrl│@ G@║ F5 │@ Jthe Modify Jpalette to the 
│
F @│ G@╚═════╛@ G@╚════╛@ Standard JEGA colors.      
│
F @│ This will restore the default colors to  
│
F @│ your Modify palette, erasing any color   
│
F @│ values you have modified.                
│
F @└──────────────────────────────────────────
┘

F @
┌──────────────────────────────────────────
┐
F @│ G@╓─────┐@ G@╓────┐@  JReset the current color  
│
F @│ G@║ Ctrl│@ G@║ F6 │@  Jvalue of the Modify      
│
F @│ G@╚═════╛@ G@╚════╛@  Jpalette to the current   
│
F @│ Standard JEGA color value.  This will     
│
F @│ change the current color of your Modify  
│
F @│ palette.  It does not affect any other   
│
F @│ colors.                                  
│
F @└──────────────────────────────────────────
┘


F @
┌──────────────────────────────────────────
┐
F @│  G@╓────┐@  JView the File Jcolor palette.    
│
F @│  G@║ F7 │@  Lets you compare the colors you 
│
F @│  G@╚════╛@  are modifying to the colors     
│
F @│  currently held in the File palette.     
│
F @│  Like F5, pressing F7 will not change    
│
F @│  the colors in the Modify palette.       
│
F @└──────────────────────────────────────────
┘

F @
┌──────────────────────────────────────────
┐
F @│  G@╓────┐@  JView the current color stored   
│
F @│  G@║ F8 │@  Jthe File Jcolor palette.         
│
F @│  G@╚════╛@  This key is the same as F7 but  
│
F @│  for the current color value.  Only the  
│
F @│  color the palette pointer is set at     
│
F @│  is affected.                            
│
F @└──────────────────────────────────────────
┘



F @
┌──────────────────────────────────────────
┐
F @│ G@╓─────┐@ G@╓────┐@  JReset the color values   
│
F @│ G@║ Ctrl│@ G@║ F7 │@  Jof the Modify Jpalette to 
│
F @│ G@╚═════╛@ G@╚════╛@  Jthe File Jpalette colors. 
│
F @│ The Modify colors will be exchanged for  
│
F @│ the colors currently stored in the file  
│
F @│ palette.                                 
│
F @└──────────────────────────────────────────
┘

F @
┌──────────────────────────────────────────
┐
F @│ G@╓─────┐@ G@╓────┐@  JReset the current color  
│
F @│ G@║ Ctrl│@ G@║ F8 │@  Jvalue of the Modify      
│
F @│ G@╚═════╛@ G@╚════╛@  Jpalette to the current   
│
F @│ File Jpalette color value.  This will     
│
F @│ change the current color of your Modify  
│
F @│ palette.  It does not affect any other   
│
F @│ colors.                                  
│
F @└──────────────────────────────────────────
┘


F  JThe colors you Modify Jcan be easily stored
  to disk by pressing the F9 Jkey.  After
  doing so, you will be asked to input a
  file name for your palette file.  Use any
  legal DOS Jfilename (you may want to consult
  your DOS manual for further information on
  DOS filenames).

  JThe F10 Jkey is used to Load Ja palette file
  from disk.  After pressing the F10 Jkey you
  will be prompted for the filename of the
  palette you wish to load.  Again, you must
  use a legal DOS filename.

  If you do not add a DOS file extension Jto
  the filename, Palet Pops Jwill automatically
  add ".ClrJ" for you.



F @┌──────────────────────────────────────────┐
F @│  G@╓────┐@  JSave palette file to disk.      │
F @│  G@║ F9 │@  You will be prompted for a      │
F @│  G@╚════╛@  legal DOS filename...           │
F @└──────────────────────────────────┬───────┘
F                                    │
F AJ╒════════════════════╡ Save Palette│File J╞═
F AJ│ Enter Filename: a:\MyColors Q════╛
F AJ│ Is a:\MyColors.Clr correct (Y or N) Q══╕
F AJ╘════════════════════════════════════════│J═
F                                          │
F J┌────────────────────────────────────────┴─┐
F J│ Once your filename is entered you will   │
F J│ be asked if the filename is correct. If  │
F J│ correct, press "Y".  Press Esc if you    │
F J│ want to return to Palette Pops.  Press   │
F J│ any other key to re-enter the filename.  │
F J└──────────────────────────────────────────┘


F @┌──────────────────────────────────────────┐
F @│ G@╓─────┐@  Load palette file to disk.      │
F @│ G@║ F10 │@  JYou will be prompted for a      │
F @│ G@╚═════╛@  Jlegal DOS Jfilename...           │
F @└──────────────────────────────────┬───────┘
F                                    │
F AJ╒════════════════════╡ Load Palette│File J╞═
F AJ│ Enter Filename: a:\MyColors Q════╛
F AJ│ Is a:\MyColors.Clr correct (Y or N) Q══╕
F AJ╘════════════════════════════════════════│J═
F                                          │
F K┌────────────────────────────────────────┴─┐
F K│ Once your filename is entered you will   │
F K│ be asked if the filename is correct. If  │
F K│ correct, press "Y".  Press Esc if you    │
F K│ want to return to Palette Pops.  Press   │
F K│ any other key to re-enter the filename.  │
F K└──────────────────────────────────────────┘


F  A┌───────────────────────────────────────┐
F  A│ In the case of file errors (such as   │
F  A│ your filename is illegal or a disk    │
F  A│ drive door is left open) JPalette Pops │
F  A│ will notify you...                    ├F─┐
F  A└───────────────────────────────────────┘F │
F                                            │
F   D┌─────────────┤ Error ├──────────────┐F   │
F   D│     File Error!  Cannot Save     Q══F═══╛
F   D│          a:\MyFile.Clr             │
F   D│    Press any key to continue...    │
F   D└────────────────────────────────────┘

F    @┌───────────────────────────────────┐
F    @│ If this should happen, don't be   │
F    @│ alarmed. Just correct your error, │
F    @│ press a key and try again.        │
F    @└───────────────────────────────────┘


F  Palette Pops Jis designed to run both as
  a memory resident Jprogram, and as a non-
  resident Jprogram.

  A memory resident program is one which
  remains in memory while another program
  is running.  You could say that it is in
  the background, while the program you are
  running is in the foreground.

  Usually, a memory resident program is
  not seen until you press a sequence of
  keys (usually referred to as "hotJ" keys)
  to bring the memory resident program to
  the foreground.  The Palette Pops Hot keys
  are Alt-TabJ.  Pressing the Alt-Tab Jkeys
  simultaneously will "Pop" it up, hence
  the name...  Palette PopsJ.

F @┌──────────────────────────────────────────┐
F @│ To make JPalette Pops memory resident type│
F @│ PaletPops /R at the DOS prompt.  This    │
F @│ tells JPalette Pops to place itself in    │
F @│ memory, and to be ready  G@╓─────┐@ G@╓─────┐@ │
F @│ to JPop Up when the hot   G@║ Alt │@ G@║ Tab │@ │
F @│ keys are pressed ══════P G@╚═════╛@ G@╚═════╛@ │
F @└──────────────────────────────────────────┘

F The Esc key performs several different tasks
               in Palette Pops:

F  @┌────────────────────────────────────────┐
F  @│ G@╓─────┐@  JONE:  First, the Esc is used  │
F  @│ G@║ Esc │@  to Escape from a function     │
F  @│ G@╚═════╛@  within JPalette Pops, such     │
F  @│ as the Help or File window, and return │
F  @│ to the JPalette Pops window.            │
F  @└────────────────────────────────────────┘


F  @
┌────────────────────────────────────────┐
F  @│ G@╓─────┐@  JTWO:  Second, when JPalette    
│
F  @│ G@║ Esc │@  Pops is not memory resident   
│
F  @│ G@╚═════╛@  the Esc key is used to exit   
│
F  @│ JPalette Pops and return you to the     
│
F  @│ DOS prompt.                            
│
F  @└────────────────────────────────────────
┘

F  @
┌────────────────────────────────────────
┐
F  @│ G@╓─────┐@  JTHREE:  And finally, pressing 
│
F  @│ G@║ Esc │@  Esc when JPalette Pops is      
│
F  @│ G@╚═════╛@  memory resident will merely   
│
F  @│ close the JPalette Pops window and      
│
F  @│ return you to what you were doing when 
│
F  @│ you pressed Alt-Tab.  Of course,       
│
F  @│ pressing Alt-Tab will still activate   
│
F  @│ JPalette Pops.                          
│
F  @└────────────────────────────────────────
┘

F  JA memory resident program is said to be
  "well-behaved" if it doesn't interfere
  with other programs you are running.

@┌────────────────────────────────────────────┐
@│ Once JPalette Pops is memory resident, it   │
@│ will detect if it can be "Popped-Up"       │
@│ while your foreground program is running.  │
@│ If it cannot, JPalette Pops will beep at    │
@│ you. JPalette Pops will not pop up in       │
@│ graphics software.                         │
@└────────────────────────────────────────────┘

B┌────────────────────────────────────────────┐
B│J The "/R" Jcommand which makes Palette Pops  │
B│J memory resident is called a parameter.     │
B│J Their are several other parameters that    │
B│ Palette Pops Jrecognizes....                │
B└────────────────────────────────────────────┘

@┌───────────────┐
────────────────────────────
┐
@│ /L Filename   │ JLoad in a color palette    
│
@╘═══════════════╛ Jfile.  If you want to load 
│
@
│ a particular set of palette colors without 
│
@
│ running Palette Pops you can do so by using
│
@
│ "/L" parameter at the DOS prompt, with the 
│
@
│ filename of the palette you wish to load...
│
@
│                                            
│
@
│      Jexample: PaletPops /L MyFile          
│
@
└────────────────────────────────────────────
┘

F JThe /L Jparameter will inform Palette Pops Jto
 LJoad the next word, i.e. your palette file.

 When /L Jis used without any other parameter
 commands it will LJoad your palette file
 without invoking Palette Pops.  JThis makes
 it easy to use the /L Jparameter in a batch
 file to load a color palette.

@┌───────────────┐
────────────────────────────
┐
@│ /P Pathname   │ JTell Palette Pops Jwhere you
│
@╘═══════════════╛ Jhave stored the Palette    
│
@
│  Pops JHelp file.  As a rule, Palette Pops  
│
@
│  looks for its help file (PaletPop.Hlp)    
│
@
│  in the directory where Palette Pops was   
│
@
│  first invoked.  You can change this with  
│
@
│  the /P parameter.  /P will inform Palette 
│
@
│  Pops where the PaletPop.Hlp file is       
│
@
│  stored.  Any legal DOS pathname may be    
│
@
│  used with the /P parameter:               
│
@
│                                            
│
@
│      Jexample: PaletPops /P A:\MyPath       
│
@
└────────────────────────────────────────────
┘

F JThe /P Jparameter will inform Palette Pops Jto
 Jrecognize the next word, (i.e. the DOS
 directory path) as the subdirectory that
 PaletPop.Hlp Jfile is stored in.

 The /RJ, /L Jand /P Jparameters can be used
 together on the DOS command line.  The
 following example illustrates this:

@┌────────────────────────────────────────────┐
@│   PaletPops J/R /L MyFile /P C:\MyPath      │
@└────────────────────────────────────────────┘

F JThe example given above will do the
 following things:

D /R            JMake Palette Pops memory
D               resident
A /L MyFile     JLoad the MyFile Jcolor
A               palette
D /P C:\MyPath  JTell Palette Pops Jto look in
               the DOS path C:\MyPath Jto find
               the Palette Pops Jhelp file
               (PaletPop.Hlp)


F JWhen memory resident programs are invoked,
 they naturally use up a section of memory
 for their program space.  Other memory
 resident programs are then permitted to be
 loaded "beneath" them, in another section
 of memory.  This capability is nice when
 you need more than one memory resident
 program in memory at the same time,
 however, problems can arise when the you
 wish to terminate one or more of these
 memory resident programs.

 You must be careful not to terminate a
 memory resident program which was loaded
 before another memory resident program.
 Doing so will leave a gap in memory where
 the terminated program resided.



F  Another thing to remember when terminating
  memory resident programs: JDo not attempt to
  terminate the program while you are
  currently in another non-resident Jprogram.
  Terminate Palette Pops, and all memory
  resident programs, at the DOS prompt.

F  J┌────────────────────────────────────────┐
F  J│ Unlike many memory resident programs   │
F  J│ which let you terminate a program      │
F  J│ anytime, anywhere, without warning,    │
F  J│ Palette Pops will prompt you with a    │
F  J│ warning before you can proceed.  This  │
F  J│ will remind you to be sure you want to │
F  J│ terminate Palette Pops before you      │
F  J│ leave a hole in memory or before you   │
F  J│ exit in the middle of a program.       │
F  J└────────────────────────────────────────┘

F JThe Ctrl-X Jkey sequence is used to terminate
 Palette Pops Jfrom memory if it is memory
 resident.  Do this only at the DOS prompt!

F @
┌──────────────────────────────────────────
┐
F @│ G@╓─────┐@ G@╓───┐@  JTerminate Palette Pops    
│
F @│ G@║ Ctrl│@ G@║ X │@  Jwhen it is resident in    
│
F @│ G@╚═════╛@ G@╚═══╛@  Jmemory.  After you press  
│
F @│ Ctrl-X a warning window will appear for  
│
F @│ you to read, which will remind you about 
│
F @│ the proper way to terminate a memory     
│
F @│ resident program.  You may press "Y" if  
│
F @│ you wish to terminate Palette Pops, or   
│
F @│ any other key to return to the Palette   
│
F @│ Pops window.                             
│
F @└──────────────────────────────────────────
┘

F  JTerminating Palette pops Jwill return you
  to the DOS prompt.

F JWe hope you like Palette PopsJ.  We created
 it for Video-7, Incorporated Jand we believe
 that you will find it a useful tool to use
 with the VEGA Deluxe.

 Palette Pops Jis also available for other EGA
 compatible boards... write for information.
F  @┌─────────────────────────────────────────┐
F  @│    JNow, available from R. W. Dunlap's   │
F  @│  Software CompanyJ, a program that will  │
F  @│ Jchange your EGA switch settings at the  │
F  @│    JDOS Prompt!  EGA Switch Jis $14.95    │
F  @└─────────────────────────────────────────┘
F      You can contact us in the heart of
F           the Silicon Valley at:
F    J┌────────────────────────────────────┐
F    J│   R. W. Dunlap's Software Company  │
F    J│           P.O. Box 23190           │
F    J│         San Jose, CA  95153        │
F    J└──────────┤[phone]├──────────┘